Update InfluxDB Docker content.md #2586

MeelahMe · 2025-06-18T15:48:14Z

This PR updates the Docker README file to clarify instructions for running the server in a container.
Changes include:

Adding clearer steps to activate a trial or home license when using Docker
Providing an example for skipping the email prompt
Improving formatting for better readability

jstirnaman · 2025-06-25T21:12:12Z

influxdb/content.md

The overview paragraph should stay general for InfluxDB (not specific to InfluxDB 3).

If docker-library doesn't generate or support a TOC, we need to be clear that the readme contains info for all 3 versions.

We need to make sure we don't lose any existing instructions. I see you're linking to the v1 and v2 docs, which is good, but we need to verify they're comprehensive.

The sample compose.yaml for all 3 would be nice to have.

jstirnaman

@MeelahMe Some fixes and suggestions.

influxdb/content.md

jstirnaman · 2025-07-01T22:40:00Z

influxdb/content.md

+  -v $PWD/data:/var/lib/influxdb3 \
+  -e INFLUX_LICENSE_KEY="YOUR_LICENSE_KEY" \
+  influxdb:enterprise serve \
+    --cluster-id cluster1 \


We should have an example using available environment variables, specific for Docker startup (if any) and InfluxDB3 variables. Users will want to source them from a file (.env, for example)

influxdb/content.md

jstirnaman · 2025-07-02T20:27:51Z

@MeelahMe quay.io is mostly used for internal user testing. Publicly, we need to point to the official image tags on DockerHub: https://hub.docker.com/_/influxdb/tags

…

On Wed, Jul 2, 2025 at 3:11 PM Jameelah Mercer ***@***.***> wrote: ***@***.**** commented on this pull request. ------------------------------ In influxdb/content.md <#2586 (comment)>: > -*If you run setup from within the container, InfluxDB stores `influx` CLI [connection configurations](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials) in the container's `/etc/influxdb2/influx-configs` file.* +- **Core:** `quay.io/influxdb/influxdb3:latest` <http://quay.io/influxdb/influxdb3:latest> @jstirnaman <https://github.com/jstirnaman> Okay, I can change them. Can you tell me why we should not be pointing to them and where I can find where to point to? — Reply to this email directly, view it on GitHub <#2586 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AABT2AZEBL3SYOLC5V6237D3GQ4IPAVCNFSM6AAAAAB7TQR6ECVHI2DSMVQWIX3LMV43YUDVNRWFEZLROVSXG5CSMV3GSZLXHMZDSOBQGQ4TIMRRHE> . You are receiving this because you were mentioned.Message ID: ***@***.***>

influxdb/content.md

jstirnaman · 2025-07-02T20:50:09Z

influxdb/content.md

-    %%IMAGE%%:1.8
+docker run -d --name influxdb3-core \
+  -v influxdb3-data:/var/lib/influxdb3 \
+  -p 8086:8086 \


...unless you set it explicitly. We should just use the default in this README.

jstirnaman

A few more suggestions--I apparently had a review in progress that I didn't submit.

.template-helpers/arches.sh

.template-helpers/generate-dockerfile-links-partial.sh

.template-helpers/variant.sh

jstirnaman · 2025-07-02T21:33:34Z

influxdb/README.md

@@ -46,7 +46,7 @@ WARNING:

 -	[`2`, `2.7`, `2.7.12`, `latest`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/Dockerfile)

-	[`2-alpine`, `2.7-alpine`, `2.7.12-alpine`, `alpine`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/alpine/Dockerfile)
+-	[`2-alpine`, `2.7-alpine`, `2.7.11-alpine`, `alpine`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/alpine/Dockerfile)


Suggested change

- [`2-alpine`, `2.7-alpine`, `2.7.11-alpine`, `alpine`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/alpine/Dockerfile)

- [`2-alpine`, `2.7-alpine`, `2.7.12-alpine`, `alpine`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/alpine/Dockerfile)

2.7.12 is the latest 2.x tag. Not sure what happened here.

hmmm odd I don't remember editing this section. Might be something on my end though.

influxdb/content.fixed.md

jstirnaman · 2025-07-08T16:42:03Z

influxdb/content.fixed.md

Is this supposed to be a separate file?

No, it is not supposed to be a separate file. I don't remember committing to this last night. Let me check what is going on.

influxdb/content.fixed.md

mysql/content.md

ros/content.md

ros/metadata.json

…EADME

… and storage configuration

…y updates

…tions

…EADME

Co-authored-by: Jason Stirnaman <[email protected]>

MeelahMe · 2025-07-08T18:39:29Z

I remember now. I was trying to fix the markdown lint CI and made a separate file as a way to test my thoughts. I must have accidentally pushed that file and not the content.md. I will make sure the content.md is up to date with our changes and remove the content.fixed.md. @jstirnaman

MeelahMe marked this pull request as draft June 18, 2025 15:50

MeelahMe marked this pull request as ready for review June 18, 2025 22:51

jstirnaman reviewed Jun 25, 2025

View reviewed changes

MeelahMe changed the title ~~Update Docker README and usage instructions~~ Update InfluxDB Docker content.md Jun 26, 2025

jstirnaman reviewed Jul 1, 2025

View reviewed changes

jstirnaman reviewed Jul 2, 2025

View reviewed changes

MeelahMe force-pushed the docs/docker-readme-update branch 2 times, most recently from 52789b3 to 7b257f1 Compare July 3, 2025 14:26

MeelahMe requested a review from jstirnaman July 8, 2025 04:34

jstirnaman reviewed Jul 8, 2025

View reviewed changes

MeelahMe added 18 commits July 8, 2025 11:10

docs: add introduction to InfluxDB 3 Core and Enterprise editions

d9cf884

docs: add InfluxDB 3 Core and Enterprise startup sections to Docker R…

534a0d2

…EADME

docs: add data persist section to Docker README

4efaabc

Updates to InfluxDB Core section

455bee9

docs: update Docker instructions for InfluxDB 3 Core with correct run…

db1f4f7

… and storage configuration

updates to data persist section

524fec5

docs: explain official images hosted on Quay.io and other explainator…

fa54770

…y updates

minor updates to transistion into v2 and v1 Docker setup

0c1aba8

docs: add Docker usage examples for InfluxDB 3 and simplify v1/v2 sec…

41c606a

…tions

add a extra line at end of doc for troubleshooting

a13dda2

updates to InfluxDB and InfluxDB 3 introductions

2fdb584

clarify version coverage and improve navigation for InfluxDB Docker R…

d84c97f

…EADME

remove autogenerated README.md and backup file from PR

0ad6b9f

trying to resolve markdown formatting to pass CI

1b105b6

docs: testing TOC

3d69426

docs: updates to TOC test

56f072e

docs: reverting TOC

c8fa071

docs: adding docker compose section to Core and embedding compose

2b9d566

MeelahMe force-pushed the docs/docker-readme-update branch from 23cdc0e to 9371c1a Compare July 8, 2025 18:10

MeelahMe and others added 22 commits July 8, 2025 11:12

Update influxdb/content.fixed.md

f7d81ae

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

439fc03

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

fcf040f

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

2b62742

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

f759939

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

cafa100

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

4cdfcab

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

a64ffc7

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

070376e

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

d36b341

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

4345351

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

9e0a0fe

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

39fcd34

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

d65fc31

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

f3adf9f

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

82fca5d

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

c0b99c8

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

3ffa52e

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

a10a869

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

2d07a2c

Co-authored-by: Jason Stirnaman <[email protected]>

Update influxdb/content.fixed.md

8791b70

Co-authored-by: Jason Stirnaman <[email protected]>

fix: consolidate updates into content.md and remove content.fixed.md

f0a4459

MeelahMe added 5 commits July 8, 2025 12:19

chore(format): trying to fix format and pass CI for markdownfmt

a3fd2d5

docs: adding v1.11 enterprise docker section

2763223

docs: updating heading structure, style, and applying markdownfmt

8c0f774

fix: remove trailing whitespace to pass markdownfmt CI

73ebb90

docs: correcting typos and removing numbered lists

d0c04e5

MeelahMe requested a review from jstirnaman July 9, 2025 18:11

	- [`2-alpine`, `2.7-alpine`, `2.7.11-alpine`, `alpine`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/alpine/Dockerfile)
	- [`2-alpine`, `2.7-alpine`, `2.7.12-alpine`, `alpine`](https://github.com/influxdata/influxdata-docker/blob/abb94994d78be45ccaa56282f36c36ad16bd5a5e/influxdb/2.7/alpine/Dockerfile)

Update InfluxDB Docker content.md #2586

Are you sure you want to change the base?

Update InfluxDB Docker content.md #2586

Uh oh!

Conversation

MeelahMe commented Jun 18, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jstirnaman left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

jstirnaman commented Jul 2, 2025 via email

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

jstirnaman left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

MeelahMe commented Jul 8, 2025

Uh oh!

Uh oh!